home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / GEOUTILS.ARJ / ICONMAKE.ENG < prev    next >
Text File  |  1992-05-16  |  6KB  |  139 lines
  1.                               ICONMAKE 1.0
  2.                       written by Marcus Groeber 1992
  3.                            Fido: 2:241/5609.1
  4.  
  5. Iconmake enables you to create your own icons for PC/Geos by converting
  6. existing picture files (PCX and ICO). These icons can be assigned to Dos files
  7. using the GEOS.INI settings; the method is the same as for the built-in icons
  8. and for those from the icon collection by Geoworks themselves.
  9.  
  10.  
  11. The technology
  12. --------------
  13. To "teach" Geoworks new icons, you'll have to create so-called "tokens". These
  14. are references to executable programs or document types, consisting of a
  15. four-letter-code and a number in the range of 0..65535. A token can be
  16. assigned the name of a program, one or more icons (for different screen types)
  17. and sometimes the name of the application that created the document.
  18.  
  19. When a directory is first opened, Geoworks loads the tokens from all
  20. applications that are not yet known into its internal TOKEN.DB database.
  21. Therefore, new tokens can be easily created by using a "dummy" application
  22. that contains not much more than the token itself. By changing into a
  23. directory with such a dummy file, the new icon is automagically installed in
  24. the system.
  25.  
  26.  
  27. The converter
  28. -------------
  29. ICONMAKE enables you to convert icons from PCX (PC Paintbrush) or ICO (Windows
  30. Icons) into such dummy applications, thus giving you access to a huge amount
  31. of graphics.
  32.  
  33. The conversion uses a code fragment from the orignal Geoworks icon collection
  34. (which is probably (c) Geoworks).
  35.  
  36. Tokens from PCX files
  37. ---------------------
  38. Each token requires up to three icon files (assume that the token name is
  39. xxxx, names are only examples):
  40.  
  41.   xxxx_CGA.PCX          Low (CGA) resolution: 48x14 pixels, mono
  42.   xxxx_HGC.PCX          High resolution mono (HGC, MCGA): 48x30 Pixel, mono
  43.   xxxx_EGA.PCX          High resolution color (EGA, VGA): 48x30 Pixel, 16 col
  44.  
  45. To create a "dummy" for the token named xxxx (will be called xxxx.000), you
  46. must enter the command
  47.  
  48.         ICONMAKE m xxxx <list of pcx files>
  49. e.g.:   ICONMAKE m icons\TEST,12345 test_cga.pcx test_hgc.pcx test_ega.pcx
  50.  
  51. at the command prompt. You can also specify an additional valued after xxxx
  52. (separated by a ",") to set the numeric component of the token to this value
  53. (default is 255). You could for example use this feature to distinguish
  54. various tokens with the same name in different collections. 
  55.  
  56. In addition, the token name can contain a full pathname that specifies where
  57. the dummy file will be put. An extension will be ignored; the name is always
  58. truncated to 4 characteres. Therefore you can specify the name of the source
  59. file as a suggested icon name in automatic batch runs, and ICONMAKE will
  60. convert it according to its standards. An existing file by the same name will
  61. never be overwritten, instead the program changes the filename to avoid name
  62. conflicts.
  63.  
  64. The filename for the token file is created by taking the token name and adding
  65. the token number (as a hex value). The extension is always "000". 
  66.  
  67. By default, als pixel with color 14 will be displayed as "transparent", i.e.
  68. the background is visible in those places. This color can be changed by
  69. specifying a different value after the "m"-option (e.g. "m1"), "m0" will
  70. completely disable transparency. The following color codes may be used:
  71.  
  72.                   black  1            dark grey  9
  73.                    blue  2           light blue  10
  74.                   green  3          light green  11
  75.                    cyan  4           light cyan  12
  76.                     red  5            light red  13
  77.                 magenta  6        light magenta  14
  78.                   brown  7               yellow  15
  79.              light grey  8                white  16
  80.  
  81. Extracting tokens from PC/Geos Files
  82. ------------------------------------
  83. The command
  84.  
  85.         ICONMAKE x <filename>
  86.  
  87. extracts icon definitions from existing Geoworks programs (or icon dummys)
  88. into pcx files (the names will follow the example given above).
  89.  
  90. Tokens from ICO files
  91. ---------------------
  92. The command
  93.  
  94.         ICONMAKE w xxxx <ICO file>
  95. e.g.:   ICONMAKE w \geoworks\icons\TEST,12345 test.ICO
  96.  
  97. will create a dummy for the token xxxx (naming conventions are the same as for
  98. pcx files) using the graphics in the given Windows icon file. ICONMAKE tries to
  99. get as many different types of icons (CGA, HGC, EGA) from the ICO file, but it
  100. will not attempt to convert a picture that is not available in a "useful"
  101. resultion. Contrary to the Geoworks standard format, the icons created by this
  102. option will usually be of 32x32 size, but this doesn't seem to pose any
  103. problems.
  104.  
  105.  
  106. Suggestions:
  107. ------------
  108.  - Once you have installed a token, any changes in the token file will go
  109. unnoticed until you delete your TOKEN.DB in the SYSTEM directory to make
  110. PC/Geos rebuild it. You don't normally loose any information by doing so,
  111. because TOKEN.DB is only a work file that can be recreated from the
  112. applications you have.
  113.  
  114.  - In some paint programs (e.g. Windows Paintbrush) you can avoid color
  115. distortions by loading and re-saving a picture.
  116.  
  117.  - Of course, the fastest way to get LOTS of icons is to take an existing PD
  118. collection for Windows and convert them using a batch command. If the pictures
  119. are packed into an EXE or DLL file, you'll have to use an icon extractor
  120. before starting ICONMAKE (e.g. Daniel Tietze's GETICONS). Most Windows
  121. collections contain only icons for EGA/VGA color resolution.
  122.  
  123.  - The following command line is very useful - it converts all Windows icons
  124. in the current directory into Geoworks icons (names must be different in the
  125. first four characters):
  126.  
  127.         FOR %a IN (*.ICO) DO iconmake w %a,254 %a
  128.  
  129. This command assign the token number 254 to all the icons (this number can of
  130. course be freely chosen).
  131.  
  132.  - Two other programs that can be very useful when working with Geoworks icons
  133.  
  134.    * ICONED by Thomas Wachsmann is a full-featured icon editor (currently :-)
  135.      Dos based).
  136.  
  137.    * TOKENVM by Rudi Ferrari enables you to assign new icons to Geoworks
  138.      documents, e.g. a picture representing the topic of a GeoWrite text.
  139.